dxp-ux

(0 reviews)

[GET] Fetch Account Properties

This operation retrieves the properties associated to a billing account number from Liberate.

URL
http://[localhost]:[port]/dxp-ux/v1/{businessId}/accounts/{accountNo}/properties
URL PARAMS
nametypedescriptionrequired
businessIdstring2 letter ISO 3166 country code (PA) identifying the business unit.Y (PA)
accountNostringbilling account numberY (PA)
Headers
nametypedescriptionrequired
client_idstringThe client_id identifying the channel.Y (PA)
client_secretstringPassword associated with the client_id.Y (PA)
X-Correlation-IDstringIdentifier that correlates HTTP request between a client and server. Any identification model (UUDI, checksum, etc.) can be used, as long as it is a unique value to differentiate a transaction.Y (PA)
Query Params
nametypedescriptionrequired (mandatory-Y, optional-N, Not applicable- N/A)
propertyTypestringType of property being fetch; Must be 'A'Y (PA)
Data Model - Response
field nametypedescriptionrequired (mandatory-Y, optional-N, Not applicable- N/A)
accountPropertiesobjectproperties associated to a billing account numberY (PA)
accountProperties.a00NoOfPdestringNumber of account level propertiesY (PA)
accountProperties.a00NoOfPde.propertiesGroup[]arrayDetails about the account propertiesN (PA)
accountProperties.a00NoOfPde.propertiesGroup[].pdePropertyNamestringName of the propertyN (PA)
accountProperties.a00NoOfPde.propertiesGroup[].pdePropertyIdstringId of the propertyN (PA)
accountProperties.a00NoOfPde.propertiesGroup[].aspPropertyValuestringValue of the propertyN (PA)
accountProperties.a00NoOfPde.propertiesGroup[].aspStartTimeStampstringstart time from which the property is applicable for the billingAccountN (PA)

accountProperties.a00NoOfPde.propertiesGroup[] subResource DataModel:

field nametypedescriptionrequired (mandatory-Y, optional-N, Not applicable- N/A)example
pdePropertyNamestringName of the propertyN (PA)PA:
"pdePropertyName": "Disney plus Entitlementid"
pdePropertyIdstringId of the propertyN (PA)PA:
"pdePropertyId": "DISNEY_ENTITLEMENTID"
aspPropertyValuestringValue of the propertyN (PA)PA:
"aspPropertyValue": "0a04ba6c-8fc3-4db4-b9d6-64db0a32051a"
aspStartTimeStampstringstart time from which the property is applicable for the billingAccountN (PA)PA:
"aspStartTimeStamp": "13-Sep-2024 14:43:41"
Key considerations
PA Implementation (Bango usecase)
  • The 'propertyType' input query parameter should be "A" to fetch account level properties from Liberate.
  • The list of accountProperties.a00NoOfPde.propertiesGroup[] in the response is based on the accountProperties.a00NoOfPde i.e., number of account level properties associated with the given billing account number.
  • Please refer the responses in following URL DXP UX API - fetch AccountProperties

Reviews